3D Graphics Programming with QuickDraw 3D 1.5.4

Reading and Writing File Subobjects

QuickDraw 3D provides functions that you can use to read QuickDraw 3D objects that are subobjects of custom objects. In general, you should call these functions only within your custom read data method. For additional routines you can use, see "Custom File Object Routines" .

Q3File_IsEndOfData

You can use the Q3File_IsEndOfData function to determine whether there is more data for your application to read.



 
TQ3Boolean Q3File_IsEndOfData (TQ3FileObject file);

file: A file object.

DESCRIPTION

The Q3File_IsEndOfData function returns, as its function result, a Boolean value that indicates whether there is more data to be read from the file object specified by the file parameter (kQ3True ) or not (kQ3False ).

SPECIAL CONSIDERATIONS

You should call this function only within a custom read data method.

Q3File_IsEndOfContainer

You can use the Q3File_IsEndOfContainer function to determine whether there are more subobjects of a custom object for your application to read.



 
TQ3Boolean Q3File_IsEndOfContainer (

                     TQ3FileObject file, 

                     TQ3Object rootObject);

file: A file object.
rootObject: A root object in the specified file object.

DESCRIPTION

The Q3File_IsEndOfContainer function returns, as its function result, a Boolean value that indicates whether more subobjects remain to be read from a custom object specified by the rootObject parameter in the file object specified by the file parameter (kQ3True ) or not (kQ3False ).

SPECIAL CONSIDERATIONS

You should call this function only within a custom read data method.